home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 1 / LIGHT-ROM 1 (Amiga Library Services)(1994).iso / ffdisks / d893.lha / AmigaWorld / Deutsch / Dokumentation < prev    next >
Text File  |  1993-06-25  |  35KB  |  723 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                 * AmigaWorld *
  14.  
  15.                          geschrieben von Wolfgang Lug
  16.  
  17.                          Dokumentation zu Version 2.0
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32. 1. Was ist AmigaWorld?
  33. ======================
  34.  
  35. AmigaWorld ist ein Datenbank-Programm, das Informationen über jedes Land der
  36. Welt beinhaltet. Sie können sich die Daten eines Landes anschauen oder die
  37. von mehreren vergleichen. Angezeigt werden u.a. Lage, Hauptstadt, Einwohner-
  38. zahl, Fläche, Sprachen, Währung und die Flagge.
  39. Das Programm ist leicht zu bedienen, und Sie können Schrift, Bildschirmmodus
  40. und Farben frei wählen. Außerdem können Sie zwischen deutscher, englischer,
  41. schwedischer und holländischer Benutzeroberfläche wählen.
  42. AmigaWorld läuft auf allen Amigas mit Kickstart 1.2/1.3 oder 2.x. Ein MByte
  43. RAM wird benötigt.
  44.  
  45.  
  46. 2. Wie starte ich AmigaWorld?
  47. =============================
  48.  
  49. Nichts leichter als das:
  50. Als Workbench-Benutzer machen Sie wie gewohnt einen Doppelklick auf das Icon.
  51. Das war's.
  52. Wenn Sie AmigaWorld vom CLI aus starten, müssen Sie sich vorher mit "cd" in das
  53. Verzeichnis begeben, in dem AmigaWorld die Länderdateien und die Ausgabetexte
  54. sucht. Meistens sieht das so aus: "cd df0:AmigaWorld". Parameter können nicht
  55. übergeben werden.
  56.  
  57. Zusammen mit AmigaWorld erhalten Sie einen Zeichensatz, der ziemlich gut für
  58. das Programm geeignet ist. AmigaWorld funktioniert auch ohne ihn, aber wenn
  59. Sie ihn benutzen möchten, können Sie ihn sehr einfach installieren: Vom CLI
  60. aus geben Sie "execute InstallFont" ein, Workbench-Benutzer machen einen
  61. Doppelklick auf das Icon von InstallFont.
  62. Egal, ob Sie den Zeichensatz installieren oder nicht, auf jeden Fall benötigt
  63. AmigaWorld die Diskfont-Library. Wenn Sie von einer normalen Workbench starten,
  64. ist sie auf jeden Fall vorhanden.
  65.  
  66.  
  67. 3. Wie bringe ich AmigaWorld dazu, Deutsch zu "sprechen"?
  68. =========================================================
  69.  
  70. Nach dem Programmstart präsentiert sich AmigaWorld zunächst einmal auf
  71. Englisch. Doch Sie können auch auf deutsche Benutzerführung und die
  72. deutschen Bezeichnungen für Länder und Städte umschalten!
  73. Dazu gehen Sie in das Menü "Configuration" und wählen den Menüpunkt
  74. "Language" aus. Nun erscheint ein Fenster, in dem Sie nach einer neuen
  75. Sprache gefragt werden. Tippen Sie jetzt "Deutsch" ein und klicken Sie
  76. mit der Maus auf "OK". AmigaWorld lädt die entsprechenden Dateien und
  77. danach läuft alles auf Deutsch.
  78. Wie Sie sehen dauert es jedoch ziemlich lang, bis die neuen Dateien geladen
  79. sind. Als registrierter Benutzer können Sie das umgehen, indem Sie den Menü-
  80. punkt "Einstellungen" / "Sichern" anwählen. Dann legt AmigaWorld beim nächsten
  81. Programmstart gleich auf Deutsch los.
  82. Auf die gleiche Art und Weise können Sie das Programm dazu bewegen, sich
  83. auf Schwedisch oder Holländisch mit Ihnen zu verständigen. Tippen Sie statt
  84. 'Deutsch' einfach 'Svenska' bzw. 'Nederlands' ein.
  85. Wenn Sie möchten, können Sie AmigaWorld auch in eine weitere Sprache über-
  86. setzen. Einzelheiten darüber finden Sie in Abschnitt 7 der Dokumentation.
  87.  
  88.  
  89. 4. Wie funktioniert AmigaWorld?
  90. ===============================
  91.  
  92. Probieren Sie es einfach aus; die meisten Funktionen sind einfach zu ver-
  93. stehen. Einige kann man allerdings beim Rumprobieren übersehen, darum folgt
  94. jetzt ein kleiner Überblick über den AmigaWorld-Bildschirm:
  95.  
  96. Die Länderliste
  97. ---------------
  98. Rechts befindet sich die Länderliste. Hier werden die Länder aufgelistet,
  99. die Sie ausgewählt haben. Sie können Länder entweder einzeln (mit der rechten
  100. Maustaste) oder in Gruppen auswählen, z.B. mit Hilfe des Auswahl-Menüs oder
  101. der Such-Funktion.
  102. Wenn Sie die linke Maustaste über dem Namen eines Landes drücken, erscheint
  103. ein Fenster, in dem die verfügbaren Daten über dieses Land angezeigt werden
  104. (Einzelheiten im Abschnitt 6). Auf diese Art und Weise können Sie gleichzeitig
  105. bis zu zehn Länder anzeigen lassen und somit leicht ihre Daten miteinander
  106. vergleichen. Die Fenster werden wieder geschlossen, indem man das Close-Gadget
  107. links oben anklickt.
  108.  
  109. Das Proportional-Gadget
  110. -----------------------
  111. Links von der Länderliste befindet sich ein Proportional-Gadget. Indem Sie
  112. die Position des schwarzen Balkens verändern, können Sie sich in der Länder-
  113. liste rauf und runter bewegen.
  114.  
  115. Die Landkarte
  116. -------------
  117. Auch die Landkarte hat zwei Funktionen:
  118. Wenn Sie mit der Maus auf die Weltkarte gehen und dann die linke Taste drücken,
  119. werden die Einstellungen im "Auswahl"-Menü wiederhergestellt, so wie sie vor
  120. dem letzten Suchen waren.
  121. Drücken Sie hingegen die rechte Maustaste über der Weltkarte, so werden alle
  122. Länder ausgewählt.
  123.  
  124. Das Such-Gadget
  125. ---------------
  126. Unter der Weltkarte ist das Such-Gadget. Wenn Sie hier einen Text eingeben und
  127. Return drücken, sucht AmigaWorld nach einem Land mit diesem Namen. Wenn Sie
  128. also "Belgien" eingeben, ist nur noch Belgien ausgewählt und wird auch gleich
  129. angezeigt. Geben Sie hingegen "Guayana" ein, werden sowohl Guyana als auch
  130. Französisch-Guayana und Suriname (ehem. Niederländisch-Guayana) ausgewählt.
  131. Wenn Sie keine Lust haben, den ganzen Namen einzutippen (oder den Namen nicht
  132. so genau wissen), dann können Sie auch nur die ersten paar Buchstaben und dann
  133. einen Stern eingeben. Wenn Sie also "Frank*" eingeben, wird Frankreich ange-
  134. zeigt.
  135. AmigaWorld kennt für viele Länder mehrere Namen: So ist es zum Beispiel egal,
  136. ob Sie "England", "UK" oder "Großbri*" eingeben; das Resultat ist immer das
  137. gleiche.
  138. Bevor Sie einen Suchvorgang starten, sollten Sie bedenken, daß AmigaWorld nur
  139. die ausgewählten Länder durchsucht. Wenn also nur die Länder Europas angezeigt
  140. sind, wird "China" nicht gefunden. Daher ist es aucb in der Regel nötig, nach
  141. einem Suchvorgang die alte Auswahl wiederherzustellen: Klicken Sie einfach
  142. auf die Weltkarte (s.o.).
  143. Sie können die Länderliste nicht nur nach Landesnamen durchsuchen lassen,
  144. sondern auch nach Hauptstädten, Sprachen oder Religionen, je nach der Ein-
  145. stellung im "Suchen nach"-Menü.
  146. Sie können die Such-Funktion übrigens auch dann noch benutzen, wenn bereits
  147. Länderfenster geöffnet sind.
  148.  
  149.  
  150. 5. Die Menüs
  151. ============
  152.  
  153. Eine Besonderheit, die keine ist
  154. --------------------------------
  155. Intuition gibt Ihnen zwei Möglichkeiten, einen Menüpunkt anzuwählen:
  156. 1.) Sie drücken die rechte Maustaste, gehen auf den Menüpunkt und lassen die
  157.     rechte Taste wieder los. Nichts Neues, oder?
  158. 2.) Sie drücken die rechte Maustaste, gehen auf den Menüpunkt und drücken jetzt
  159.     einmal die LINKE Maustaste.
  160. Vermutlich fragen Sie sich jetzt, warum ich mir die Mühe mache, das hinzu-
  161. schreiben. Ganz einfach: Mit der zweiten Methode können Sie nicht nur einen
  162. Menüpunkt auswählen, sondern gleich drei oder vier: Halten Sie einfach die
  163. rechte Taste gedrückt und klicken Sie mit der linken herum, soviel Sie wollen.
  164. Sie können also auf einen Schlag die Auswahl der Kontinente vornehmen oder alle
  165. Einstellungen im "Anzeigen"-Menü gleichzeitig verändern.
  166. Das geht wesentlich schneller, als wenn man jedesmal darauf warten muß, bis
  167. ein einzelner Menüpunkt vom Programm abgearbeitet wurde.
  168. Aus irgend einem Grund gibt es immer noch viele Programme, die diese Möglick-
  169. keit nicht nutzen, obwohl sie nicht schwer zu programmieren ist. Registrierte
  170. Benutzer können ja mal im kommentierten Source-Code nachsehen!
  171.  
  172.  
  173. So, als nächstes kommt eine Beschreibung der einzelnen Menüpunkte:
  174.  
  175. Das "AmigaWorld"-Menu
  176. ---------------------
  177. "Über AmigaWorld"    zeigt, wer's gemacht hat.
  178. "Benutzer"           zeigt in der Freeware-Version an, wie man registrierter
  179.                         Benutzer wird und was man davon hat.
  180.                         Ist man glücklicher Besitzer der Vollversion, kann man
  181.                         hier seinen eigenen Namen wiederfinden.
  182. "Übersetzer"         Ein kleiner Dank an Bo Arnholm und Ruud Hoekzema, die
  183.                         AmigaWorld in ihre Muttersprachen übersetzt haben.
  184. "Ende"               beendet AmigaWorld. Ohne nervende Abfrage!
  185.  
  186.  
  187. Das "Auswahl"-Menü
  188. ------------------
  189. Mit den ersten sechs Menüpunkten können Sie einstellen, welche Kontinente in
  190. die Auswahl-Liste aufgenommen und somit dargestellt werden. Wenn Sie also nur
  191. etwas über die Länder Afrikas erfahren möchten, dann schalten Sie den Rest
  192. der Welt doch einfach ab!
  193. "Abhängige Gebiete"  Ist dieser Menüpunkt aktiv, so werden nicht nur selb-
  194.                         ständige Staaten ausgewählt, sondern auch alle anderen
  195.                         Länder und Gebiete, z.B. Hong Kong oder Grönland.
  196.  
  197.  
  198. Das "Sortieren"-Menü
  199. --------------------
  200. Je nachdem, welcher Menüpunkt aktiviert ist, so präsentiert sich die Länder-
  201. liste. Wird z.B. "BSP/Kopf" angewählt, werden die reichsten Länder ganz oben
  202. angesiedelt und die ärmsten ganz unten.
  203. "Name"               Die Gebiete werden alphabetisch geordnet.
  204. "Fläche"             Das Land mit der größten Fläche (Rußland) wird zuerst
  205.                         angezeigt.
  206. Die weiteren Menüpunkte funktionieren entsprechend.
  207.  
  208.  
  209. Das "Anzeige"-Menü
  210. ------------------
  211. Dieses Menü bestimmt das Aussehen der Länderliste. Es ist vor allem in Verbin-
  212. dung mit dem "Sortieren"-Menü interessant:
  213. "Rangnummer"         Die Länder werden durchnumeriert: Wenn Sie sie also
  214.                         im Auswahl-Menü nur noch "Europa" aktiviert haben und
  215.                         im Sortieren-Menü "Einwohnerzahl" angewählt ist, sieht
  216.                         der Beginn der Liste so aus:
  217.                            1 Rußland
  218.                            2 Deutschland
  219.                            3 Großbritannien ...
  220. "Offizielle Namen"   Statt der gebräuchlichen Namen (z.B. Deutschland) werden
  221.                         die offiziellen aufgelistet (z.B. Bundesrepublik
  222.                         Deutschland). Ziemlich sinnlos.
  223. "Wert"               Ist diese Option aktiv, so wird hinter jedem Land der Wert
  224.                         angezeigt, nach dem die Liste sortiert ist. Ist die
  225.                         Liste nach Namen sortiert, passiert gar nix.
  226. "Alle Länder"        Ist diese Option gesetzt, so werden nicht nur die aus-
  227.                         gewählten Länder angezeigt, sondern auch alle anderen,
  228.                         allerdings in einer anderen Farbe, so daß eine Unter-
  229.                         scheidung möglich ist.
  230.                         Dieser Menüpunkt ist sehr hilfreich, wenn man die
  231.                         Länder der Auswahl mit dem Rest der Welt vergleichen
  232.                         will. Sie können z.B. die Liste nach dem BSP ordnen
  233.                         und dann mal schauen, wie die EG-Länder im inter-
  234.                         nationalen Vergleich abschneiden.
  235.                         Außerdem können Sie nun mit der rechten Maustaste
  236.                         Länder einzeln in die Auswahl aufnehmen.
  237.  
  238. Das "Suchen nach"-Menü
  239. ----------------------
  240. Wenn Sie im Gadget links unten einen Text eingeben, sucht AmigaWorld normaler-
  241. weise nach einem Land, dessen Name so lautet. Je nach der Auswahl in diesem
  242. Menü können Sie aber auch nach anderen Dingen suchen lassen:
  243. "Name"               ist die Voreinstellung.
  244. "Lage"               Bei diesem Menüpunkt sollte man meistens den Stern mit-
  245.                         eingeben, weil sonst diejenigen Länder unter den Tisch
  246.                         fallen, deren Lage genauer angegeben ist. Beispiel:
  247.                         Wenn Sie "Mittelamerika" eingeben, erhalten Sie nur die
  248.                         Länder auf der mittelamerikanischen Landbrücke.
  249.                         Geben Sie hingegen "Mittelamerika*" ein, wird auch die
  250.                         karibische Inselwelt angezeigt.
  251. "Hauptstadt"         Beim nächsten Suchen werden die Länder ausgewählt, deren
  252.                         Hauptstädte ihrer Eingabe entsprechen.
  253.                         Wenn Sie also "Bo*" eingeben, werden nur noch die
  254.                         Länder Deutschland (Bonn) und Kolumbien (Bogota) an-
  255.                         gezeigt.  Geben Sie "Ber*" ein, werden Deutschland
  256.                         (Berlin) und die Schweiz (Bern) ausgewählt.
  257. "Sprache"            Sie wollen alle Länder wissen, in denen man Englisch,
  258.                         Türkisch oder KiSuaheli spricht - kein Problem!
  259. "Religion"           Die Such-Funktion reagiert nicht auf den Namen der Reli-
  260.                         gion (z.B. Islam), sondern auf die Bezeichnung für
  261.                         deren Angehörige (z.B. Muslime).
  262. "Währung"            Man kann nur nach der Haupteinheit (z.B. Dollar), nicht
  263.                         aber nach Untereinheiten (z.B. Cent) suchen.
  264. "Organisation"       Dieser Menüpunkt ist anders als die anderen: Sie können
  265.                         keine Eingabe im String-Gadget machen, sondern ein
  266.                         neues Fenster mit einer Liste aller Organisationen
  267.                         erscheint. Klicken Sie auf die gewünschte, und eine
  268.                         Beschreibung derselben erscheint.
  269.  
  270. Natürlich kann man mehrmals hintereinander nach verschiedenen Sachen suchen;
  271. So können Sie z.B. herausfinden, welche afrikanischen Länder Mitglied der OPEC
  272. und außerdem islamisch sind.
  273.  
  274.  
  275. Das "Einstellungen"-Menü
  276. ------------------------
  277. Hiermit können Sie das äußere Erscheinungsbild von AmigaWorld ziemlich weit-
  278. gehend Ihren Vorstellungen anpassen:
  279. "Farben"             Ein Farbrequester erscheint. Registrierte Benutzer können
  280.                         ihn übrigens spielend leicht in eigene Programme ein-
  281.                         bauen.
  282. "Interlace"          Wenn Sie einen Flickerfixer oder sehr widerstandsfähige
  283.                         Augen haben, dann können Sie hiermit die Bildschirmhöhe
  284.                         verdoppeln (und wieder halbieren).
  285. "Schrift"            Wenn Ihnen mein schöner Zeichensatz nicht gefällt, dann
  286.                         können Sie hier einen anderen einstellen. Die Größe
  287.                         sollte 15 Punkt nicht überschreiten.
  288. "Sprache"            Hiermit können Sie mit AmigaWorld in einer anderen Sprache
  289.                         kommunizieren. Zur Zeit haben Sie die Wahl zwischen
  290.                         Deutsch, Englisch, Schwedisch und Holländisch.
  291. "Speichern"          Sie haben keine Lust, jedesmal nach dem Programmstart
  292.                         erst die deutsche Version einzuschalten, dann ihren
  293.                         Lieblingszeichensatz und dann noch ihre Spezialfarben?
  294.                         Dann speichern Sie ihre Einstellungen doch einfach.
  295.                         Beim nächsten Programmstart schaut AmigaWorld dann
  296.                         gleich aus wie gewünscht.
  297.  
  298.  
  299.  
  300.  
  301. 6. Das Länderfenster
  302. ====================
  303.  
  304. Die Daten, die im Länderfenster angezeigt werden stammen größtenteils aus
  305. dem Fischer-Weltalmanach 1993 (Redaktionsschluß: September '92). Ich habe
  306. jedoch auch andere Quellen verwendet, z.B. andere Bücher, Zeitungsartikel
  307. oder auch Informationen, die mir meine Benutzer geschickt haben.
  308.  
  309. Zu den meisten Sachen, die im Länderfenster angezeigt werden, gibt es wenig
  310. zu sagen; ein paar Punkte möchte ich aber erklären.
  311.  
  312.  o Name:        Manche Länder haben ihren Namen vor nicht allzu langer Zeit
  313.                     geändert, z.B. Birma in Myanmar oder Obervolta in Burkina
  314.                     Faso. Wenn Sie also ein Land in der Länderliste nicht
  315.                     finden, liegt das vermutlich daran, daß Sie nach einem
  316.                     veralteten Namen suchen. Tippen Sie den Namen ins Such-
  317.                     Gadget ein, dann zeigt ihnen AmigaWorld das Land (mit
  318.                     seinem neuen Namen).
  319.  o Hauptstadt:  Zuerst wird ein Name in der Landessprache angegeben, dann in
  320.                     der deutschen Übersetzung, wenn diese abweichend ist.
  321.  o Sprache:     Natürlich sind nicht alle Sprachen aufgelistet, die in einem
  322.                     Land verbreitet sind, aber die wichtigsten. Alle Sprachen,
  323.                     die von mehr als einem Zehntel der Landesbevölkerung ge-
  324.                     sprochen werden, sind jedenfalls erwähnt.
  325.  o Religion:    Hier gilt das gleiche wie bei den Sprachen: Natürlich sind
  326.                     nicht alle aufgelistet, aber die am meisten verbreiteten.
  327.                     Vielfach sind Prozentangaben gemacht, die natürlich nur
  328.                     Anhaltspunkte sein können; in verschiedenen Quellen weichen
  329.                     sie zum Teil erheblich voneinander ab. Für manche Länder
  330.                     ergibt sich eine Summe von mehr als 100%. Das ist kein
  331.                     Fehler (jedenfalls meistens nicht ...), sondern darin
  332.                     begründet, daß manche Menschen zwei Religionsgemeinschaften
  333.                     angehören.
  334.  o Organisat.:  Die Organisationen, die AmigaWorld kennt, sind nicht in jeder
  335.                     Übersetzung gleich; die niederländische Version beinhaltet
  336.                     z.B. mehr als die deutsche, weil Ruud Hoekzema die Daten
  337.                     selbst gesammelt hat.
  338.  
  339.  
  340. 7. Die awo-Dateien
  341. ==================
  342. Dieser Abschnitt ist eigentlich nur dann interessant, wenn Sie AmigaWorld in
  343. eine weitere Sprache übersetzten möchten. Dazu müßten Sie sich nämlich mit den
  344. folgenden vier Dateien befassen:
  345.  
  346. awo.cfg
  347. -------
  348. Nach dem Programmstart lädt AmigaWorld eine Reihe von Dateien nach. Da ist
  349. zunächst die Konfigurations-Datei "awo.cfg". Sie wird zu allererst gelesen
  350. und teilt AmigaWorld mit, welche Sprache, welcher Zeichensatz und welche
  351. Farben verwendet werden sollen. Diese Datei wird vom Programm selbst erstellt,
  352. wenn man den Menüpunkt "Einstellungen"/"Speichern" anwählt. Wird die Datei
  353. nicht gefunden, arbeitet das Programm mit den Voreinstellungen.
  354. Da man die Datei ziemlich leicht mit einem Texteditor verändern kann, fehlt
  355. sie in der Freeware-Version, sorry.
  356.  
  357. awo.output
  358. ----------
  359. Die Datei "awo.output" enthält alle Texte, die AmigaWorld ausgibt.
  360. Es ist nicht sehr schwer, eine weitere Übersetzung von "awo.output" zu erstel-
  361. len: Sie laden eine fertige "awo.output"-Datei und übersetzen sie Zeile für
  362. Zeile in die neue Sprache. Das Ergebnis speichern Sie dann in dem entsprechen-
  363. den neuen Verzeichnis; eine italienische Version wäre also unter dem Namen
  364. "Italiano/awo.output" abzuspeichern.
  365. Wenn Sie nun AmigaWorld starten und 'Italiano' als Sprache eingeben, können
  366. Sie überprüfen, ob Sie alles richtig gemacht haben; wenn Sie Syntax-Fehler
  367. gemacht haben, teilt Ihnen AmigaWorld mit, was passiert ist, und in welcher
  368. Zeile. Manchmal können diese Meldungen allerdings recht verwirrend sein: Das
  369. liegt dann daran, daß Sie beim Übersetzen in der Zeile verrutscht sind, so
  370. daß das Programm einen falschen Text ausgibt.
  371. Es ist übrigens möglich, Kommentare einzubauen: Alles, was hinter einem Semi-
  372. kolon ';' steht, wird überlesen. Andererseits können Sie daher natürlich keine
  373. Ausgabetexte benutzen, in denen ein Semikolon vorkommt, denn das Programm würde
  374. nur den ersten Teil davon einlesen.
  375. Vielleicht wundern Sie sich über die vielen leeren Zeilen? Sie sollen in künf-
  376. tigen Versionen weitere Ausgabetexte aufnehmen, so daß neue Texte nicht ohne
  377. jeden Zusammenhang ans Ende angehängt werden müssen.
  378. Zeilen, die nur einen Stern '*' enthalten, werden intern verwaltet (z.B. meine
  379. Adresse).
  380. Ach ja, nochwas: Die Datei muß mit "AWO-Output" beginnen und mit einem '#'
  381. enden. Beachten Sie dabei die Groß-/Klein-Schreibung von "AWO-Output"!
  382.  
  383.  
  384. awo.data
  385. --------
  386.  
  387. Diese Datei ist die wichtigste überhaupt. Sie enthält die Informationen über
  388. die Länder. Diese sind so aktuell wie möglich (-> Abschnitt 6), aber bei der
  389. ungeheuren Menge der Daten wäre es merkwürdig, wenn nicht immer noch einige
  390. Eingabefehler unentdeckt geblieben wären.
  391. Trotzdem möchte ich Sie bitten, keine veränderten Länder-Dateien weiterzugeben,
  392. sondern nur meine Originale. Teilen Sie mir lieber mit, welche Fehler Sie ge-
  393. funden haben! Ich bin gerne bereit, diese auszubessern. So werden ihre Korrek-
  394. turen einer wesentlich größeren Zahl von Benutzern zugänglich gemacht.
  395.  
  396. Es folgt ein Überblick über den Aufbau von "awo.data":
  397.  
  398. Die Länder sind in der Reihenfolge aufgelistet, in der sie später angezeigt
  399. werden sollen, also alphabetisch. Die Informationen für ein Land werden dabei
  400. in dreizehn aufeinanderfolgenden Zeilen abgelegt:
  401.  
  402. Zeile  1: Die gebräuchlichen Landesnamen.
  403.           Nur der erste wird in der Länderliste angezeigt, aber beim Suchen
  404.           werden auch die anderen berücksichtigt. Die einzelnen Namen werden
  405.           durch einen senkrechten Stich '|' getrennt. Der erste Name darf 120
  406.           Zeichen lang sein, alle weiteren nur 30 Zeichen.
  407.           Beispiel: "Niederlande|Holland"
  408. Zeile  2: Hier befindet sich die Code-Nummer des Landes. Sie ist in jeder
  409.           Übersetzung von 'awo.data' die gleiche (z.B. 54 für Finnland) und
  410.           dient beispielsweise dazu, einem Land die Datei mit seiner Flagge
  411.           zuzuordnen.
  412. Zeile  3: Der offizielle Landesname.
  413.           Hier darf nur ein einziger Name angegeben werden. Das reicht auch,
  414.           da man ohnehin nicht nach dem offiziellen Namen suchen lassen kann.
  415. Zeile  4: Das Auto-Kennzeichen.
  416.           Bei selbständigen Staaten steht hier das Autokennzeichen, z.B. "F"
  417.           für Frankreich. Bei abhängigen Gebieten wird hingegen das Kennzeichen
  418.           des Mutterlandes angegeben, und zwar in eckigen Klammern, also z.B.
  419.           "[F]" für Martinique oder Französisch-Polynesien.
  420.           Wenn das Kennzeichen nicht bekannt ist, ist ein Fragezeichen '?'
  421.           angegeben. Kennzeichen dürfen nicht länger als drei Buchstaben sein.
  422. Zeile  5: Die Lage des Landes:
  423.           Zuerst werden die Kontinente angegeben, und zwar als Zahlen:
  424.           1 = Afrika, 2 = Amerika, 3 = Asien, 4 = Australien und Ozeanien,
  425.           5 = Europa, 6 = Polargebiete.
  426.           Dann folgt ein senkrechter Strich '|' und danach die Lage als Text.
  427.           Beispiel: "53|Ost-Europa und Nord-Asien" für Rußland.
  428. Zeile  6: Die Hauptstadt:
  429.           Zuerst wird hier der vollständige Ausgabetext (max. 120 Zeichen)
  430.           angegeben, so wie er im Länder-Fenster erscheinen soll, danach
  431.           kommen durch senkrechte Striche getrennt die einzelnen Bezeich-
  432.           nungen (max. 30 Zeichen), auf die der Such-Algorithmus reagieren
  433.           soll.
  434.           Beispiel: "Berlin (Regierungssitz Bonn)|Berlin|Bonn"
  435. Zeile  7: Die Sprache(n).
  436.           Hier stehen die Landessprachen. Die Anordnung funktioniert genauso
  437.           wie bei den Hauptstädten.
  438.           Beispiel: "Englisch und Französisch|Englisch|Französisch"
  439. Zeile  8: Die Religion(en).
  440.           Genauso wie schon bei den Hauptstädten oder Sprachen.
  441. Zeile  9: Die Fläche in km².
  442.           Es werden nur Ganzzahlen akzeptiert. Störend ist das eigentlich
  443.           nur beim Vatikan, den man theoretisch auf 0 abrunden müßte ...
  444. Zeile 10: Die Einwohnerzahl.
  445. Zeile 11: Das Bruttosozialprodukt in Millionen US-$.
  446. Zeile 12: Die Währung des Landes. Hier werden Haupt- und Untereinheiten
  447.           angegeben, außerdem mehrere Namen für den Such-Algorithmus.
  448.           Also genau das gleiche wie schon bei den Hauptstädten oder den
  449.           Sprachen.
  450. Zeile 13: Die Organisationen, denen das Land angehört:
  451.           Zuerst Klartext für das Ausgabefenster, danach eine Code-Nummer
  452.           für jede Organisation. Diese Nummern müssen mit denen in der Datei
  453.           'awo.org' übereinstimmen, damit der Such-Algorithmus funktioniert.
  454.  
  455. Zur besseren Übersichtlichkeit kann man beliebig viele Leerzeilen einfügen,
  456. am besten eine nach jedem Land.
  457. Auch Kommentare sind möglich: Wie in 'awo.output' wird alles ignoriert, was
  458. hinter einem Semikolon steht. Achten Sie aber darauf, daß Sie das Semikolon
  459. DIREKT hinter den eigentlichen Text setzen.
  460. Beispiel: "Burkina Faso; ehemaliges Ober-Volta"
  461. Wenn Sie das nämlich nicht tun, liest AmigaWorld sämtliche Leerzeichen vor dem
  462. Semikolon mit, was später beim Suchen zu Problemen führt.
  463.  
  464. Die Datei muß mit "AWO-Datafile" beginnen und mit einem '#' abgeschlossen
  465. werden.
  466.  
  467. Wenn Sie "awo.data" übersetzen wollen, sollten Sie wissen, daß Sie sich einiges
  468. vorgenommen haben. Ich hab's gemerkt, als ich die englische Version erstellt
  469. habe (würg).
  470. Immerhin hilft einem AmigaWorld ein wenig dabei: Wenn Sie nämlich beim Über-
  471. setzen Syntax-Fehler machen, also z.B. eine Zahl löschen oder zu lange Texte
  472. eingeben, sagt Ihnen das Programm, was passiert ist, und in welcher Zeile.
  473.  
  474.   Eine ganz, ganz große Bitte habe ich jedoch: Bitte setzen Sie sich mit mir
  475.   in Verbindung, BEVOR Sie das Programm übersetzen! Denn es dürften mindestens
  476.   zwei Monate vergehen zwischen dem Tag, an dem ich Fred Fish das Programm
  477.   schicke, und dem Tag, an dem Sie es erhalten. Sollte ich in der Zwischen-
  478.   zeit schon von jemand anders eine Übersetzung in der betreffenden Sprache
  479.   erhalten haben, wäre das doch wirklich ärgerlich für Sie.
  480.   Außerdem war es bei der Schwedischen und Holländischen Version so, daß
  481.   sie mich erreichten, als ich schon neue Zeilen in die Länderdatei einge-
  482.   fügt hatte. Diese fehlten natürlich zunächst in den Übersetzungen!
  483.   Also bitte, bitte: Schicken Sie mir nicht "einfach so" ihre Übersetzung,
  484.   sondern schreiben Sie mir vorher!
  485.  
  486.  
  487. awo.org
  488. -------
  489.  
  490. Ab Version 2.0 gibt es noch eine neue Datei: Sie heißt 'awo.org' und enthält
  491. die Beschreibungen der internationalen Organisationen.
  492. Die Datei muß mit der Kennung 'AWO-Organisations' beginnen und - wie immer -
  493. mit einem Doppelkreuz '#' enden.
  494.  
  495. Dazwischen befinden sich die Beschreibungen der einzelnen Organisationen.
  496. Diese sind wie folgt angeordnet:
  497.  
  498. Zeile 1:    Der Name der Organisation, so wie er in dem Fenster erscheinen
  499.               soll, das geöffnet wird, wenn man den Menüpunkt "Suchen nach" /
  500.               "Organisation" anwählt.
  501. Zeile 2:    Die Code-Nummer, die mit denen in 'awo.data' übereinstimmen muß.
  502. Zeile 3-x:  Die Beschreibung der Organisation. Sie darf maximal 10 kByte lang
  503.               sein und sollte mit einer Textverarbeitung erstellt werden,
  504.               da außer bei Absätzen keine Zeilenvorschübe (Linefeeds) enthalten
  505.               sein sollten. Sonst funktioniert der automatische Zeilenumbruch
  506.               nämlich nicht.
  507. Zeile x+1:  Damit AmigaWorld merkt, daß die Beschreibung zu Ende ist, muß hier
  508.               ein Backslash '\' stehen.
  509.  
  510. Kommentare können hier NICHT eingegeben werden, damit man das Semikolon in den
  511. Beschreibungen verwenden kann.
  512.  
  513.  
  514.  
  515. Wohin damit?
  516. ------------
  517.  
  518. Wie schon erwähnt: Wenn Sie AmigaWorld übersetzen möchten, dann sollten Sie
  519. die neuen Dateien in einem Verzeichnis mit dem Namen der Sprache ablegen. Doch
  520. was ist, wenn sie nicht alle drei Dateien, sondern nur eine oder zwei über-
  521. setzt haben?
  522. Ein Beispiel: Sie haben 'awo.output' und 'awo.org' ins Norwegische übersetzt,
  523. dann hat Sie die Lust verlassen und sie wollen das deutsche 'awo.data'-File
  524. mitverwenden. Statt es nun ins Verzeichnis 'Norsk' zu kopieren, können Sie
  525. es einfach ins Mutterverzeichnis verschieben; das spart etwas Platz auf der
  526. Diskette/Festplatte. Die Verzeichnisstruktur sähe also so aus:
  527.  
  528.     AmigaWorld (dir)
  529.         AmigaWorld
  530.         awo.data
  531.         Deutsch (dir)
  532.             awo.output
  533.             awo.org
  534.         Norsk (dir)
  535.             awo.output
  536.             awo.org
  537.  
  538.  
  539. 8. Rechtliches
  540. ==============
  541.  
  542. Alle Leute, die ein Programm schreiben, bringen diesen Absatz in ihrer Doku-
  543. mentation; also muß wohl irgendein Sinn dahinterstecken:
  544.  
  545.   Das Programm wird "im gegenwärtigen Zustand" bereitgestellt, ohne Garantien
  546.   jedweder Art. Der Autor übernimmt insbesondere keine Garantie bezüglich der
  547.   Richtigkeit, Genauigkeit oder Gültigkeit der Daten. Der Autor ist nicht
  548.   verantwortlich für Schäden jedweder Art, die durch die sachgemäße oder un-
  549.   sachgemäße Anwendung des Programmes entstehen. Die Anwendung des Programmes
  550.   geschieht auf eigenes Risiko.
  551.  
  552.  
  553. 9. Vertrieb
  554. ===========
  555.  
  556. Die eingeschränkte Freeware-Version von AmigaWorld kann beliebig weitergegeben
  557. werden: Jeder darf sie jedem anderen kopieren, solange er für die Diskette,
  558. die AmigaWorld enthält, nicht mehr verlangt als DM 8, US$ 5 oder den entspre-
  559. chenden Betrag in einer anderen Währung. Nur Mr. Fred Fish aus Tempe/Arizona
  560. darf soviel verlangen, wie er will.
  561. Außerdem darf AmigaWorld nur in vollständiger Form weitergegeben werden.
  562. Folgende Dateien müssen also vorhanden sein:
  563.  
  564.      Svenska (dir)
  565.        awo.data                         awo.org
  566.        awo.output                       ReadMe
  567.        ReadMe.info
  568.      Fonts (dir)
  569.           Lucifer (dir)
  570.             8
  571.        Lucifer.font
  572.      Flags (dir)
  573.        011                              014
  574.        100                              104
  575.        142                              181
  576.        213                              227
  577.        231                              234
  578.        244
  579.      Deutsch (dir)
  580.        awo.data                         awo.org
  581.        awo.output                       Dokumentation
  582.        Dokumentation.info               Einschränkungen
  583.        Einschränkungen.info             Entwicklung
  584.        Entwicklung.info
  585.      English (dir)
  586.        awo.data                         awo.org
  587.        awo.output                       Documentation
  588.        Documentation.info               History
  589.        History.info                     Limitations
  590.        Limitations.info
  591.      Nederlands (dir)
  592.        awo.data                         awo.org
  593.        awo.output                       ReadMe
  594.        ReadMe.info
  595.   AmigaWorld                       AmigaWorld.info
  596.   Deutsch.info                     English.info
  597.   InstallFont                      InstallFont.info
  598.   Nederlands.info                  Svenska.info
  599.  
  600. Die Vollversion für registrierte Benutzer darf nicht weitergegeben werden,
  601. nur die Teile des Quellcodes, die als Public Domain gekennzeichnet sind.
  602. Der Lucifer-Zeichensatz ist Public Domain. Sie können ihn also verändern,
  603. weitergeben und in eigenen Programmen verwenden.
  604.  
  605.  
  606. 10. Wie wird man registrierter Benutzer?
  607. =======================================
  608.  
  609. Wenn Ihnen AmigaWorld gefällt, dann werden Sie doch registrierter Benutzer!
  610. Registrierte Benutzer erhalten von mir die neueste Programm-Version, natürlich
  611. ohne die lästigen Einschränkungen der Freeware-Version.
  612. Dazu bekommen Sie alle Flaggen und die neuesten Länderdateien in allen Spra-
  613. chen, die mir zur Verfügung stehen. Außerdem werde ich Ihnen den Quellcode des
  614. Programmes senden. Er dürfte für jeden Modula-2-Programmierer interessant sein,
  615. vor allem folgende Teile:
  616.  
  617.     EasyIntuition   enthält Prozeduren zum Erstellen von Screens, Windows und
  618.                     Menus. Der Modul schließt beim Programmende oder bei einem
  619.                     Absturz alle Screens und Windows automatisch wieder. Das
  620.                     kann während der Programmentwicklung sehr hilfreich sein,
  621.                     da keine Bildschirm-Leichen wertvollen Speicher wegnehmen.
  622.     EasyGadgets     enthält Prozeduren zum Erstellen und Verwalten von Gadgets,
  623.                     natürlich im 3D-Look von Kickstart 2.0.
  624.     ColorRequest    enthält den Farbrequester.
  625.     Vanilla         gehört noch nicht wirklich zum Quellcode, ist aber recht
  626.                     interessant: Der Modul wandelt die RawKey-Ereignisse in
  627.                     ASCII-Codes um, wobei die Spezialtasten (Cursor, Help, ...)
  628.                     gesondert berücksichtigt werden. Außerdem können Sie
  629.                     abfragen, welche Sondertasten gedrückt sind und ob Zahlen
  630.                     auf dem Zehnerblock gedrückt wurden. Wenn man ein Programm
  631.                     schreiben möchte, daß sowohl die nationalen Tastatur-
  632.                     belegungen als auch Spezialtasten erkennt, ist Vanilla
  633.                     sehr hilfreich. Vanilla basiert auf einem Modul von
  634.                     Fiabbian G. Dufoe und Peter Graham Evans, der sich auf
  635.                     AmigaLibDisk 344 befindet. Nur deshalb brauchen Sie die
  636.                     Vollversion also nicht zu ordern.
  637.     Examples        Dazu gibt's ein paar kleine Beispielprogramme, die die
  638.                     Benutzung der oben genannten Moduln demonstrieren.
  639.  
  640. Außerdem haben Sie als registrierter Benutzer die Möglichkeit, AmigaWorld neu
  641. zu compilieren, wenn Sie den m2Amiga-Compiler besitzten. Da ich noch mit der
  642. Uralt-Version 3.3 arbeite, dürfte Ihr Kompilat deutlich kürzer ausfallen als
  643. meines.
  644.  
  645. Wenn Sie also registrierter Benutzer werden möchten, dann schicken Sie bitte
  646. DM 30,- an:
  647.                 Wolfgang Lug
  648.                 Altmühlstraße 20a
  649.                 65207 Wiesbaden
  650.                 Deutschland
  651.  
  652. Wenn Sie schon registrierter Benutzer sind, können Sie die neueste Version
  653. von AmigaWorld gegen Einsendung von DM 10,- (Europa) oder US-$ 10,- (Rest
  654. der Welt) bei mir erhalten.
  655.  
  656. Natürlich bin ich als armer Zivi vor allem auf Ihr Geld scharf, aber ich freue
  657. mich auch über jede andere Reaktion auf AmigaWorld!
  658. Wenn Sie also Verbesserungsvorschläge haben, oder wenn Sie wissen, wie man
  659. Fenstern den 3D-Look verleiht, ohne TagItems zu verwenden, dann schreiben Sie
  660. mir!
  661. Wenn Sie Fehler im Programm oder in den Datenfiles gefunden haben, dann teilen
  662. Sie es mir mit! In künftigen Versionen werde ich Ihre Korrekturen berücksich-
  663. tigen. Ich glaube, ich würde es sogar verkraften, wenn ein fleißiger Englisch-
  664. lehrer mir seine Korrektur der englischen Dokumentation schickt ...
  665. Außerdem finde ich mein Icon etwas einfallslos - Wenn Sie also ein schöneres
  666. erfinden und zeichnen wollen: Tun Sie sich keinen Zwang an!
  667.  
  668. In der ersten Version stand hier noch die Bitte, mir ohne vorherige Rück-
  669. sprache Übersetzungen zu schicken.
  670. Das hat sich als etwas ungeschickt erwiesen, da die übersetzten Datenfiles ein
  671. wenig hinter den neuesten Programmversionen hinterherhinkten! Die holländische
  672. Version kam z.B. an, einen Tag nachdem ich die Währungs-Zeile eingebaut hatte.
  673. Außerdem kann es so natürlich passieren, daß sich vor Ihnen schno jemand
  674. anders die Mühe gemacht hat, AmigaWorld in die gleiche Sprache zu übersetzen.
  675. Daher möchte ich Sie bitten, mir VORHER zu schreiben, wenn Sie vorhaben, das
  676. Programm zu übersetzen.
  677. Wenn Sie der erste sind, der für die betreffende Sprache eine Übersetzung
  678. erstellt, bekommen Sie nach wie vor ihr Geld zurück bzw. die Vollversion
  679. kostenlos.
  680.  
  681.  
  682. Danksagung
  683. ==========
  684.  
  685. So, zum Schluß möchte ich noch ein paar Leuten danken:
  686.  
  687. Alexander Linke      dafür, daß er mir gezeigt hat, was für ein mächtiges
  688.                      Werkzeug Modula-2 ist.
  689.  
  690. Bernd Preusing       für seinen Modul "IntuiPointer", der den "zzz"-Mauszeiger
  691.                      produziert.
  692.  
  693. Kai Bolay            für ImageConvert, womit ich die Weltkarte und die Titel-
  694.                      schrift in Quellcode umgewandelt habe.
  695.  
  696. Stefan Salewski      für seinen ILBMHandler, mit dessen Hilfe die Flaggen
  697.                      geladen werden.
  698.  
  699. Jean-Michel Forgeas  für seinen großartigen Editor "Az", mit dem ich diese
  700.                      Dokumentation und fast alle AmigaWorld-Dateien erstellt
  701.                      habe. Für alle, die ihn ausprobieren möchten: Er befindet
  702.                      sich auf AmigaLibDisk 346!
  703.  
  704.  
  705. Mein besonderer Dank gilt
  706.  
  707. Bo Arnholm           für seine Übersetzung ins Schwedische und seine
  708.                         Verbesserungsvorschläge. Momentan arbeitet er
  709.                         gerade an Beschreibungen zu den einzelnen
  710.                         Ländern, vor allem zu ihrer Geschichte.
  711.  
  712. Ruud Hoekzema        für seine Übersetzung ins Holländische und seine
  713.                         Korrekturen an der Länderdatei. Er hat mir außerdem
  714.                         dabei geholfen, die Angaben über Religionen und
  715.                         internationale Organisationen zu sammeln und
  716.                         einzugeben.
  717.  
  718.  
  719.  
  720.             V I E L    S P A S S    M I T    A M I G A W O R L D  !
  721.  
  722.                             und denkt dran: IBM sucks
  723.